package com.example.project.service;

import java.util.List;

import com.example.project.entity.IssueComment;

/**
 * 需求评论服务接口
 */
public interface IssueCommentService {
    
    /**
     * 查询需求评论
     * 
     * @param id 需求评论主键
     * @return 需求评论
     */
    IssueComment selectIssueCommentById(Long id);
    
    /**
     * 查询需求评论列表
     * 
     * @param issueComment 需求评论
     * @return 需求评论集合
     */
    List<IssueComment> selectIssueCommentList(IssueComment issueComment);
    
    /**
     * 根据需求ID查询评论列表
     * 
     * @param issueId 需求ID
     * @param includeInternal 是否包含内部评论
     * @return 评论列表
     */
    List<IssueComment> selectCommentsByIssueId(Long issueId, Boolean includeInternal);
    
    /**
     * 新增需求评论
     * 
     * @param issueComment 需求评论
     * @return 结果
     */
    int insertIssueComment(IssueComment issueComment);
    
    /**
     * 修改需求评论
     * 
     * @param issueComment 需求评论
     * @return 结果
     */
    int updateIssueComment(IssueComment issueComment);
    
    /**
     * 批量删除需求评论
     * 
     * @param ids 需要删除的需求评论主键
     * @return 结果
     */
    int deleteIssueCommentByIds(Long[] ids);
    
    /**
     * 删除需求评论信息
     * 
     * @param id 需求评论主键
     * @return 结果
     */
    int deleteIssueCommentById(Long id);
    
    /**
     * 添加评论并通知相关人员
     * 
     * @param issueComment 评论内容
     * @param notifiedUsers 需要通知的用户ID列表
     * @return 结果
     */
    boolean addCommentWithNotification(IssueComment issueComment, List<Long> notifiedUsers);
}